home *** CD-ROM | disk | FTP | other *** search
/ Game Classics 18 / Game Classics 18 .iso / SPACE / SPACED / README.DOC < prev    next >
Text File  |  1996-02-05  |  21KB  |  469 lines
  1.                            ------------------------
  2.                            SPACED 2.1 Documentation
  3.                            ------------------------
  4. LEGAL STUFF
  5. ___________
  6.  
  7.      Before we get into the goodies I have to blabber some legal stuff so that
  8.      I don't get sued by some genius that was playing the game in the bathtub
  9.      during a lightning storm.  So here we go:
  10.  
  11.      I am not responsible for any effects (except euphoria) that this software
  12.      has on you, your computer, your family, your friends, your pets, or
  13.      anything else related to you or anyone else or anything in the world.
  14.  
  15.      In this document, the phrase "this software" shall refer to the game
  16.      "SPACED 2.1" and its associated files.
  17.  
  18. BUG FIXES FROM VERSION 2.0
  19. __________________________
  20.      A)   Not having a mouse driver loaded will NO longer cause the main menu
  21.           to "flash" and disappear (essentially crashing the game.)  This
  22.           cheesy bug was caused by me forgetting to remove the mouse code from
  23.           my menu object, since I had used the menu object in making some
  24.           drawing utilities.  Oops!
  25.  
  26.      B)   Firing a whole bunch of lasers as a level change comes into effect
  27.           will no longer cause a "laser shortage" in the next level
  28.           (characterized being unable to fire very often)  The game engine
  29.           usually knows how many lasers are "out there" on the screen, but the
  30.           nuke_everything() function, which is called at the end of every
  31.           level, forgot to remove them.  This caused the number-of-lasers
  32.           variable to become maxed out too quickly, but now the function
  33.           remembers...
  34.  
  35. DISTRIBUTION
  36. ____________
  37.  
  38.      You are free to distribute and copy this software wherever and to whomever
  39.      you like with no obligations AS LONG AS:
  40.  
  41.      a.   You distribute ALL of the files (including this one) that constitute
  42.           this software.  These include:
  43.                SPACED.EXE
  44.                SETUP.EXE
  45.                SPACED.BIG
  46.                README.DOC
  47.           
  48.      b.   You don't modify any of the files that constitute this software,
  49.           except for that modification which occurs as a result of running
  50.           SPACED.EXE or SETUP.EXE.
  51.  
  52.  
  53. SYSTEM REQUIREMENTS
  54. ___________________
  55.  
  56.      Required:
  57.           80386 or better microprocessor
  58.           400K  of conventional memory
  59.           1M of hard disk space
  60.           VGA or compatible video card
  61.  
  62.      Recommended:
  63.           Sound Blaster or compatible
  64.           1 megabyte of expanded memory (EMS)
  65.  
  66.      Not Supported:
  67.           joystick
  68.           mouse
  69.           multiplayer games
  70.           VR helmets (aww, too bad!)
  71.  
  72.      Note:
  73.           The sound mixer may not work correctly with some computer systems.  I
  74.           once thought the problem was dependent on the type of sound card, but
  75.           now I have narrowed it down to being either the DMA controller or the
  76.           speed of the CPU.  I have found the code to work fine on a 386/40, a
  77.           486/25, and a 486/33; okay on a Pentium-120; but not too well on a
  78.           486/100.  This is puzzling.  I will try to fix this in a future
  79.           version.  If the digital sound is non-existent or plagued with
  80.           clicking or buzzing, you may have to settle for the less-cool-but-
  81.           still-rockin' PC-speaker sound effects.  Sorry.
  82.  
  83.  
  84. INSTRUCTIONS
  85. ____________
  86.  
  87.  
  88.      KEYS AND WHAT THEY DO
  89.      _____________________
  90.  
  91.      To skip out of the introduction/story sequence or a demo, press ESC.
  92.  
  93.      Arrow keys (up, down, left, right):
  94.           These move the spaceship around the screen.
  95.  
  96.      If you are lost, go back to KEYS AND WHAT THEY DO and try reading this
  97.      section again.
  98.  
  99.      Ins:
  100.           This changes how fast your spaceship moves.  The indicator at the
  101.           right of the screen will tell you what speed you are currently on: 
  102.           Slow, Normal, Turbo, or Fast.  If you have problems controlling
  103.           yourself, you may want to leave it on Slow or Normal.
  104.  
  105.      Alt:
  106.           Fires your laser(s).  You have unlimited ammo, so don't hold back!
  107.  
  108.      Spacebar:
  109.           Releases a bomb that inflicts damage to everything on the screen. 
  110.           You get three of these with each new ship.  Use them frugally!
  111.  
  112.      F1:
  113.           Pauses the game and displays a help screen.
  114.  
  115.      S:
  116.           Toggles the sound effects.
  117.  
  118.      M:
  119.           Toggles the music.
  120.  
  121.      ESC:
  122.           Offers you a change to quit the level.
  123.           Important:     Pressing ESC is equivalent to killing all of your
  124.                          remaining ships at once, and costs you a continue if
  125.                          you suddenly change your mind and want to keep
  126.                          playing.  So be careful with it!
  127.  
  128.  
  129.      GAME PLAY
  130.      _________
  131.  
  132.      YOUR MISSION:
  133.           Get the crystal back from the geeks so your fellow countrymen of
  134.           Atlantis will stop drooling on their shirts and return to their
  135.           normal state.
  136.  
  137.      YOUR MISSION PLAN:
  138.           Fire lots of lasers; drop lots of bombs; kill lots of enemies.
  139.  
  140.  
  141.      Every so often a power-up orb will go floating by.  Here's what they do:
  142.  
  143.      RED:      INCREASES SHOT POWER
  144.      ORANGE:   GIVES YOU ANOTHER BOMB
  145.      BLUE:     GIVES YOU ANOTHER LIFE
  146.  
  147.      The complex and intriguing story will tell itself as you go along.
  148.      Good luck!
  149.  
  150.      PARAMETERS
  151.      __________
  152.  
  153.  
  154.      /playdemo [name]    Run a previously recorded demo.
  155.  
  156.      /record [name] Record a demo.
  157.  
  158.      /fast          Allows the game to run as fast as the computer will allow. 
  159.                     It is kind of fun to watch demos this way, but doesn't help
  160.                     much when you're playing normally - especially if you own a
  161.                     Pentium.
  162.  
  163.      /buffer [size] This sets the length (in bytes) of the digital sound mixing
  164.                     buffers.  The default is 256.  Smaller buffer lengths will
  165.                     result less delay between the digital sound request and the
  166.                     actual playing of the sound, but every time the mixer
  167.                     reaches the end of a buffer, it makes a small click, and
  168.                     when the buffer length becomes too small the clicking sound
  169.                     becomes annoying, and the sound is tinny.
  170.  
  171.                     As mentioned above, sound cards on some systems click very
  172.                     loudly, and make decent sound playback impossible.  I am
  173.                     working on fixing this.
  174.  
  175.      /no jokes      Turns off the silly wordage at the bottom of the screen.
  176.  
  177.      /i suck        Resets the high score list.
  178.  
  179.  
  180.      Parameters may be stacked on the command line as needed, in any order. 
  181.      For instance, the entry:
  182.  
  183.           spaced /playdemo mydemo.rec /buffer 128 /no jokes /i suck [ENTER]
  184.  
  185.      Will erase the high score file, disable the text, set the mixing buffer to
  186.      128 bytes, and play back the demo file MYDEMO.REC (that would have to have
  187.      been previously recorded by someone.)  Keep in mind that the text will
  188.      remain disabled and the mixing buffer will remain at 128 bytes until you
  189.      quit the game, even if you exit the demo and start up a new game.
  190.  
  191.  
  192. TROUBLESHOOTING
  193. _______________
  194.  
  195.  
  196. PWBFAQ's - Probably will be frequently-asked questions.
  197.  
  198.      "When I run SPACED with digital sound, it tells me that I need to set up
  199.      EMS for the sound to work.  How do I do that?"
  200.  
  201.           ->   You will need to include the following lines in your CONFIG.SYS
  202.                file:
  203.  
  204.                DEVICE=C:\dos\HIMEM.SYS
  205.                device=c:\dos\emm386.exe 1024
  206.  
  207.           ->   If you are running Windows 95 (and SPACED doesn't work), you
  208.                have two choices:
  209.  
  210.           a.   Click once on the icon representing SPACED.  Then go to the FILE
  211.                menu and click on PROPERTIES.  Click on the MEMORY tab, and
  212.                specify that you want 1024k of EMS.
  213.  
  214.           b.   Click on SPACED, then FILE menu, then PROPERTIES, like above. 
  215.                Next click on the PROGRAM tab, click on ADVANCED, click in the
  216.                box marked MS-DOS MODE, click in the box marked SPECIFY NEW MS-
  217.                DOS CONFIGURATION, and click on the CONFIGURATION button.  A
  218.                list of boxes will pop up.  Make sure the EXPANDED MEMORY box is
  219.                checked, then click on OK.
  220.  
  221.                The first way is quicker, because it doesn't require a reboot to
  222.                play the game.  The second way gives you a bit better
  223.                performance because Windows 95 isn't in there stealing CPU
  224.                cycles, but you must reboot to play.  You can increase
  225.                performance while playing it the first way by picking PROPERTIES
  226.                under the FILE menu and turning down the idle sensitivity to
  227.                low.
  228.  
  229.  
  230.      "When I run SPACED with digital sound, it makes this ghastly buzzing sound
  231.      whenever a sound is played."
  232.  
  233.           This happens on some systems.  I am trying too find out what to do
  234.           about it, but I figured that I would release the game in its current
  235.           state so that some people could enjoy it while I worked out the bug. 
  236.           Sorry if it happens to you.
  237.  
  238.  
  239.  
  240.      "I get an OUT OF CONVENTIONAL MEMORY error when I try to run SPACED."
  241.           
  242.           DOS users:
  243.                You need to run fewer TSR's upon bootup.  Things like Doskey,
  244.                mouse drivers, CD-ROM drivers, and pop-up menu programs all use
  245.                up conventional memory.  Try remarking these lines out of your
  246.                AUTOEXEC.BAT (by typing "REM" and a space in front of them.)
  247.  
  248.           Windows 95 users:
  249.                Make sure your conventional memory is set to "AUTO."  If that
  250.                doesn't work, you may need to run the program in MS-DOS mode
  251.                with a special AUTOEXEC.BAT and CONFIG.SYS configured.  Please
  252.                refer to part B of the digital sound PWBFAQ two questions ago.
  253.  
  254.  
  255.      "I played for 40 hours straight and got 999,999 points, and then I got
  256.      this error message saying that I can't save my high score!  I am very
  257.      angry."
  258.  
  259.           This usually will happen on a network.  Network Administrators
  260.           usually put games in places where everyone can read the game files
  261.           but no one can write to them.  This is good because it keeps idiots
  262.           from going in and wiping stuff out.  It is bad because no one can
  263.           write to the high score file.  The solution is to have a big
  264.           important network person change the access rights to the file
  265.           GOODGUYS.DAT so that everyone can read and write to it.  If that is
  266.           not possible, then write/create access should be given to the entire
  267.           directory.  The worst that could happen is that some insignificant
  268.           grunt could wipe out the game.  However, this risk is a small
  269.           sacrifice for the fun of competing for a high score.
  270.  
  271.      "When I was in the 'wanna continue?' menu, none of the keys work.  I had
  272.      to reset."
  273.  
  274.           The way out of this is to remember if you were holding a key (like
  275.           Alt) down during a level change, and then press and release that key
  276.           again.  If this doesn't work, then just hit a whole bunch of keys. 
  277.           The explanation?  Between each level, the keyboard interrupt is
  278.           released and re-captured.  If a key is held down during this time,
  279.           sometimes this will mess up some flags or something in the DOS
  280.           keyboard handler, which is used by the menu system (but not the
  281.           gameplay system)  Sorry, but this is a difficult bug to track down
  282.           and fix.
  283.  
  284.  
  285. STORY BEHIND THE GAME
  286. _____________________
  287.  
  288.      So who says that one guy can't make a game?  I notice that lots of people
  289.      are studying the different aspects of game-making, but few people actually
  290.      have time to complete a game.  Fortunately, most of these people make
  291.      their code and knowledge available to the public so that others may learn
  292.      from it.  To those individuals - I thank you, and I'm sure most other
  293.      designers/coders feel the same.
  294.  
  295.      When I first started SPACED, (during my junior year in high school,) I had
  296.      no idea about how to code for the Sound Blaster, mix sounds, use EMS
  297.      memory, and a lot of other important stuff.  when I "finished" it up, it
  298.      had PC speaker sound and music, and plenty of bugs.  It was also called
  299.      "Crusade for the Crystal," and had even cheesier text than it does now. 
  300.      It was in that state that I entered it in "Tech Challenge '94" at the
  301.      Oregon Institute of Technology.  Fortunately none of the bugs popped up
  302.      during the presentation and I got first in my category.
  303.  
  304.      After that, I sort of let the project sit during my senior year, while I
  305.      got into some 3-D Studio work.  Then during summer, I got ahold of some
  306.      Sound Blaster information, which allowed me to write an FM synthesis
  307.      sequencer and digital sound mixer.  I only use the sequencer for the
  308.      ending song, however, and the other songs are converted at run-time from
  309.      the PC speaker music format to FM music.  So it sounds a bit cheesy, but I
  310.      didn't have time to write all-new songs for the levels.  Anyway, I redrew
  311.      a lot of the graphics, and basically prettied up the game real good for
  312.      its release.
  313.  
  314.      SPACED was a game made just to see if I could make a game.  I didn't
  315.      attempt anything spectacular, but I wanted to make it enjoyable and fun. 
  316.      I think that I succeeded there.  The control feels good, people who aren't
  317.      playing can read the text, the sounds are satisfying, and there are some
  318.      fun options.  Another thing that I think adds to the fun is that each of
  319.      the level backgrounds is distinctly unique.  Too many games have levels
  320.      that all look pretty much the same.  And the game will run on any '386 and
  321.      up, and at 35 frames per second if you use a '386/33 or better.  Since
  322.      every bit of real-time graphics is assembly language, and the sprite
  323.      drawing routines use run-length-encoded files, this makes the game run
  324.      pretty fast.  
  325.  
  326.      Interesting facts about SPACED
  327.      ______________________________
  328.  
  329.           SPACED was coded on a 486SX/25 with 4 Megs of RAM.  For the past six
  330.           months it has had a bug that causes it to wait an average of three
  331.           minutes before it boots.  The clock (but not the date) resets to an
  332.           arbitrary time following each reboot.  The old box, however, is still
  333.           limping along.
  334.  
  335.           The rainfall sound (outside the buildings) in level 3 was actually
  336.           made by crinkling a plastic bag in front of a microphone at a high
  337.           frequency and then slowing it down a bit.
  338.  
  339.           SPACED is composed of over 50 C++ modules, and 19 assembly language
  340.           routines. The final build included over 16,000 lines of (used) C++
  341.           code, and over 3,000 lines of assembly code.
  342.  
  343.  
  344.      
  345.      So you be asking, is there going to be another game?  The answer is yes, I
  346.      already am working on the design for my next one.  I am really excited
  347.      about the engine I have planned for it, but I can not release any details
  348.      right now because as a single developer who can not spew out games at the
  349.      rate of large game companies, it would mean that someone could take the
  350.      ideas and make a crummy clone before the real game was halfway done.  When
  351.      mine is done though, it will do things that have never been done before in
  352.      PC games.  AND IT WILL NOT BE A DOOM CLONE!  Doom is a great game, and
  353.      there are many good clones.  But the genre is overpopulated.  My next game
  354.      will, of course, be much better than SPACED, and have a more serious tone
  355.      to it.  It will not be a side-scrolling spaceship game like SPACED either. 
  356.      No more non-interactive-watch-the-background-scroll-by-and-shoot-things
  357.      theme.  And most important of all, it will be FUN to play.  It will
  358.      probably be optimized for the dual instruction pipelines and other neat
  359.      features of Pentium processors, and my estimated (emphasis on ESTIMATED -
  360.      no guarantees here!) release date is Summer 1997.  But enough said.  I
  361.      will post an announcement on my home page, newsgroups, etc. when enough of
  362.      it is finished so that I won't have to worry about companies whipping out
  363.      clones.
  364.  
  365.  
  366.  
  367. PLEA FOR MONEY
  368. ______________
  369.  
  370.      I won't deny at all that I had a lot of fun creating SPACED.  But I also
  371.      like to do lots of other things like running, skiing, writing poetry, etc. 
  372.      And when I'm doing sports I don't have a whole lot of time to earn extra
  373.      money, except during the summer, and that is mostly spent on college
  374.      expenses.  Game developers are always in need of money - to buy faster
  375.      computer systems, better compilers, and more powerful utilities, to name a
  376.      few things.  College isn't very cheap either!
  377.  
  378.      So I would appreciate it very much, if you are not in financial
  379.      difficulty, and you have the time, if you could send $2 to my mailing
  380.      address below.  I figure that if enough people do this, it may help pay
  381.      for the new computer that I need, and take care of some college expenses. 
  382.      HOWEVER, YOU HAVE ABSOLUTELY NO OBLIGATION TO DO THIS even if you've
  383.      played SPACED for 30 million hours and made $1,000 selling computer time
  384.      to the neighborhood kids.  If you don't send anything, I am still glad
  385.      that you enjoyed the game.  It is really a thrill to know that someone
  386.      appreciates my work, so I wouldn't mind any letters or e-mails telling me
  387.      what you think.  Remember, SPACED is FREEWARE to be distributed *freely*
  388.      WITHOUT ANY FINANCIAL OBLIGATION.  Have fun with it!
  389.  
  390.  
  391. SPECIAL THANKS
  392. ______________
  393.  
  394.      Josh Stevens:
  395.           Programming Advice
  396.  
  397.      Mark Betz:
  398.           Timing Routines
  399.  
  400.      Trevor Robinson:
  401.           Sound Blaster Info
  402.  
  403.      Draeden/VLA:
  404.           DMA Info
  405.  
  406.      Mark Feldman:
  407.           Author of the Game Programmers' Encyclopedia
  408.  
  409.  
  410. MY ADDRESSES
  411. ____________
  412.  
  413.      SCHOOL ADDRESS:
  414.           Daniel Haffner
  415.           P.O. BOX 2177-OIT
  416.           Klamath Falls, OR 97601
  417.           
  418.           I will be here during the school year, and mail sent here at other
  419.           times will be forwarded to my current address.
  420.  
  421.      HOME ADDRESS:
  422.           Daniel Haffner
  423.           Rt. 1, Box 1460
  424.           Bandon, OR, 97411
  425.  
  426.           Stuff sent here will always get to me - just a couple weeks later.
  427.  
  428.      EMAIL ADDRESS:
  429.           haffner@mail.oit.osshe.edu
  430.  
  431.      HOME PAGE URL:
  432.           www.oit.osshe.edu/~haffner
  433.  
  434.  
  435. FINAL WORDS
  436. ___________
  437.  
  438.      So now I will leave you with a little poem I wrote.  Although SPACED is
  439.      freeware, there is plenty of commercial software out there that is written
  440.      by game developers (and other programmers) whose living depends on
  441.      software sales.  These people are hurt by software piracy, and so are the
  442.      consumers who have to pay more for the software.  So play fair!
  443.  
  444.  
  445.  
  446.                         The Piracy Police
  447.                               by
  448.                          Daniel Haffner
  449.                         
  450.  
  451. So you're copying licensed data off of someone else's disk!
  452. You'd better bolt your doors up if you're gonna take that risk.
  453. There's nasty little demons out there waiting just to feast
  454. On users who don't know about the Piracy Police.
  455.  
  456. They come at night while you're asleep and seek out your computer,
  457. They plug her in, they find the switch, and last of all they boot 'er,
  458. And if your source disks can't be found, they smile their evil smiles,
  459. And go to work in rabid droves, deleting all your files.
  460.  
  461. Their teeth are made of silicon, their claws of leathermans.
  462. They jump on you, in vicious wrath, and cut off both your hands.
  463. "If you can't type, then you can't swipe!" they chant throughout your home,
  464. And make you truly wish that you had left those files alone!
  465.  
  466. So little boys and little girls, when software comes your way,
  467. Resist the urge to stick it in your drive for just today.
  468. And maybe you'll avoid being mauled by grimy little beasts,
  469. Known only to the user as "THE PIRACY POLICE..."